home *** CD-ROM | disk | FTP | other *** search
/ Software Vault: The Gold Collection / Software Vault - The Gold Collection (American Databankers) (1993).ISO / cdr35 / rnet200f.zip / README!.NOW < prev    next >
Text File  |  1993-06-02  |  6KB  |  128 lines
  1. -------------------------------------------------------------------------------
  2.    What you MUST do to support both message NDX and IDX's with PCBoard 15.0
  3. -------------------------------------------------------------------------------
  4.  
  5.   CDC didn't document this well enough since I'm finding out that many folks
  6.   out there are not doing everything needed to support both IDX and NDX.  This
  7.   document tells you exactly what you need to do in order to support both IDX
  8.   and NDX files.  It doesn't matter if you are or are not using RNET (as it
  9.   knows about these problems and tries to get around them).  The following
  10.   MUST be done to keep the old and new indexes in sync when running mixed
  11.   utilities!
  12.  
  13. (1) Set PCB= environment to include /OLDINDEX (this tells PCBOARD to update
  14.     the NDX when it writes a message)
  15.  
  16. (2) Include /OLDINDEX on all PCBPACK commandlines!  (THIS IS A MUST!)
  17.  
  18. (3) Every time a utility is used that writes to NDX but does NOT know how to
  19.     support the IDX (like MarkMail or TXT2MSG 2.39- or PostLink 1.05) *OR* a
  20.     utility writes to the IDX but does not update the NDX (like PostLink 1.06
  21.     or UUPCB), you MUST call PCBPACK /AREA:xx /UPDATE /INDEX /OLDINDEX.
  22.  
  23.     If you fail to include /OLDINDEX, you will find that utilities that
  24.     support only the NDX get out of sync (MarkMail will create trashed QWK
  25.     packets, PCBoard will no longer be able to keep up the NDX correctly,
  26.     PostLink 1.05 will not 'see' the messages, Qmail 4 will miss messages).
  27.     If the IDX and NDX are out of sync, PCBoard, PostLink 1.06, UUPCB, and
  28.     similar IDX only programs will not 'see' NDX based messages.
  29.  
  30.     During your normal "real" packing events, the /UPDATE should not be there
  31.     but the /OLDINDEX *MUST* be there to keep the IDX and NDX in sync.  Your
  32.     normal "real" packing events might look something like this:
  33.  
  34.     ┌─
  35.     │ PCBPACK /AREA:ALL /KILLDUPS /KILLBAK /MAX:500 /MIN:100 /OLDINDEX
  36.     └─
  37.  
  38.     Note the /OLDINDEX param MUST be there or the NDX files will not be kept
  39.     up to date with the packed conference!  If any messages are deleted, the
  40.     NDX file will no longer be correctly in sync and you'll lose messages in
  41.     any utility that only knows about the NDX's!
  42.  
  43.   This third item is what most folks are missing out on.  For each and every
  44.   utility that writes a PCBoard message that does not support both IDX and NDX
  45.   files, you MUST do a PCBPACK /AREA:xx /INDEX /OLDINDEX.  As an example, if
  46.   running TXT2MSG 2.39-, everywhere you make a call to TXT2MSG, you need to
  47.   make a call to PCBPACK right after:
  48.  
  49.     ┌─
  50.     │ REM ** use TXT2 to put message in main board...
  51.     │ TXT2MSG 0 -tSYSOP -fEVENT -sEVENT_LOG c:\pcb\EVENT.LOG
  52.     │ PCBPACK /AREA:0 /UPDATE /INDEX /OLDINDEX
  53.     └─
  54.  
  55.   The same is true if running PostLink 1.05 (since it doesn't know about the
  56.   IDX files) *OR* PostLink 1.06 (since it doesn't support the NDX files):
  57.  
  58.     ┌─
  59.     │ REM ** PostLink
  60.     │ k:
  61.     │ cd\postlink
  62.     │ POSTLINK caller.cfg
  63.     │ TELIX -sPOSTCALL
  64.     │ POSTLINK caller.cfg /continue
  65.     │ c:
  66.     │ cd\pcb
  67.     │ PCBPACK /AREA:200-228 /UPDATE /INDEX /OLDINDEX
  68.     └─
  69.  
  70.   That's the easy thing to do.  Once you get all of your utilities up to date
  71.   (ie. they support the IDX's *AND* you no longer need the NDX's), you can
  72.   then remove the PCBPACK line.  If *ANYTHING* on your system still uses the
  73.   old NDX's, you will need to leave that line in there even if the utility in
  74.   question supports the IDX's but not the NDX's.  If it supports both IDX and
  75.   NDX (like RNET v2), than the PCBPACK is no longer needed.
  76.  
  77.   Now the difficult one to catch -- MarkMail (or any other mail door that only
  78.   supports the NDX's). In the batch file that calls MarkMail (such as
  79.   C:\PCB\DOORS\MM.), you need to add a statement to create a 'flag file' so
  80.   you know that a user has used MarkMail during that call.  My MM batch looks
  81.   like this:
  82.  
  83.    ┌─
  84.    │ @echo off
  85.    │ echo ** Loading MarkMail **
  86.    │ n:\doors\mm2\mm.exe
  87.    │ rem >c:\pcb\fixindex.flg   <--- NOTE! Creates a flag file for $$LOGOFF
  88.    │ c:\pcb\board.bat
  89.    └─
  90.   
  91.   Ok, now create a C:\PCB\$$LOGOFF.BAT file to update the IDX/NDX's after the
  92.   user logs off.  I use this method to avoid taking up the users online time
  93.   by updating the indexes after they logoff.  This *CAN* result in missing
  94.   mail (if running a multi-node system) since the time from the message
  95.   insertion from a REP until the user logs off might be significant.  To cut
  96.   down on the chance for missing mail, you could move the PCBPACK stuff into
  97.   the C:\PCB\DOORS\MM batch and pack the indexes every time a user exits
  98.   MarkMail -- but that can be harsh on a user's time. I'll go with the chance
  99.   of an occasional loss and wait until the user logs off by using $$LOGOFF.BAT
  100.  
  101.     ┌─
  102.     │ @echo off
  103.     │ echo ** $$LOGOFF.BAT  --  Checking need to update IDX/NDX's
  104.     │ if not exist c:\pcb\flagindex.flg goto END
  105.     │ PCBPACK /AREA:0-52    /UPDATE /INDEX /OLDINDEX
  106.     │ PCBPACK /AREA:99-228  /UPDATE /INDEX /OLDINDEX
  107.     │ PCBPACK /AREA:250-500 /UPDATE /INDEX /OLDINDEX
  108.     │ del c:\pcb\fixindex.flg
  109.     │ :END
  110.     └─
  111.  
  112.   I use three calls to PCBPACK to avoid packing unavailable (unused) confs.
  113.   Adjust your /AREA:...'s to reflect the conference setup on your system.
  114.  
  115.   The last line deletes the flag file we created in the MM batch.  Note that
  116.   the $$LOGOFF.BAT file is called *after* the user logs off (and the modem
  117.   goes off-hook).  This way, the users time isn't taken up by the updating and
  118.   the indexes are 'fixed' NOW instead of waiting for a later event.
  119.  
  120. -------------------------------------------------------------------------------
  121.   Conclusion:  If you have missing mail, or your users are getting corrupted
  122.   QWK packets, or there are dups coming out of your mail door, or PCBoard is
  123.   reporting "no messages found" when a Y;S says there are, the problem is from
  124.   the NDX and IDX files being out of sync.  If you fail to run PCBPACK often
  125.   enough and where required when running a "mixed" NDX and IDX system where
  126.   utilities aren't updating BOTH all the time, you *will* have these problems!
  127. -------------------------------------------------------------------------------
  128.